README.TXT


     WHAT IS CMAKE?:

     CMAKE is a program maintenance utility designed especially for the
     Microsoft(R) C and Microsoft Windows(TM) programmer.  For the
     commands:

           CL, LIB, LINK, MASM, RC, and COPY,

     CMAKE automatically determines all dependencies directly from the
     command line.


     DISTRIBUTION FILES:

     CMAKE is distributed as three self-extracting archive files.

     CM100EXE.EXE - Executable and Samples.

                    This is all you need to get started, but you should
                    seriously consider getting, CM100HLP.EXE, if you
                    don't already have it.

     CM100HLP.EXE - Microsoft QuickHelp-Compatible Help File.

                    This is the complete manual for CMAKE.  It can be
                    viewed with the program, QH.EXE, which is
                    distributed with the Microsoft C Optimizing
                    Compiler 6.00 and the Microsoft Macro Assembler
                    6.00.  The CMAKE help file is similar in style to
                    the QuickHelp files that Microsoft distributes with
                    its C and Assembler packages.

     CM100TXT.EXE - ASCII Text-File Version of the Help File in
                    CM100HLP.EXE.

                    The information contained in this file is identical
                    to that of CM100HLP.EXE.  It is only included for
                    those users who either do not have the Microsoft
                    QuickHelp program, QH.EXE, or would like a
                    printable version of the CMAKE help file.


     INSTALLATION:

     To install CMAKE,

     1. Create a directory for CMAKE on the target drive.
     2. Copy your distribution files into the newly created directory.
     3. Execute the self-extracting distribution files (in any order).


     PRINTING THE DOCUMENTS:

     The following command may be used to print the document files
     that are included with CMAKE 1.00:

         copy *.txt prn


     GETTING STARTED:

     1. PUT CMAKE.EXE IN YOUR PATH

     2. REVIEW THE SAMPLES

        The sample programs will teach you how to use CMAKE to maintain
        your application.  In addition, the samples provide make files,
        LIB response files, and LINK response files that you may use as
        templates for your application.

        The CMAKE QuickHelp file provides a convenient way to study the
        samples.  If you select "Samples" from the CMAKE Contents
        screen, you will be able to view all of the samples files
        provided with CMAKE.

        The sample in the directory, SAMPLE\C, will probably be of
        interest to everyone.  This sample will show you how to use
        CMAKE to maintain an application that is built with the
        Microsoft C programs: CL, LIB, and LINK.

        If you are a Microsoft Windows programmer, study the sample in
        the directory, SAMPLE\WINDOWS.

        If you use MASM, review the sample in the directory,
        SAMPLE\MASM.

        If you would like to know how to expand CMAKE's command
        vocabulary (beyond CL, LIB, LINK, MASM, RC, COPY, SET, and
        REM), you should review the samples in the directories,
        SAMPLE\CMDDEF and SAMPLE\CMDEQUIV.

        The sample in the directory, SAMPLE\CFG, contains a
        configuration file that gives a complete list of all possible
        configuration statements.

        If you have a situation where you would like to explicitly
        specify dependencies (as you would with a generic make
        utility), review the sample in the directory, SAMPLE\IF.

        If you would like to know how CMAKE handles the MS-DOS(R) COPY
        command, you should review the sample in the directory,
        SAMPLE\COPY.


        For each sample that you study, you should:

           - Read the files, "README.TXT" and "MAKEFILE", that are
             included with the sample.
           - Run CMAKE on the sample.
           - Touch/modify some source files and run CMAKE again to see
             how well CMAKE automatically determines which commands
             are required to renew the sample application.


     3. USE QUICK HELP (QH.EXE) TO VIEW THE HELP FILE

        The help file, CMAKE.HLP, is compatible with Microsoft's
        QuickHelp Facility.  (The QuickHelp facility, QH.EXE, is
        distributed with the Microsoft C Optimizing Compiler 6.00 and
        the Microsoft Macro Assembler 6.00.  If you do not have QH.EXE,
        you can use the file, CMAKE.TXT, which is the ASCII text-file
        version of the file, CMAKE.HLP, and is contained in the
        distribution file, CM100TXT.EXE.)

        Add the path of the file, CMAKE.HLP, to your HELPFILES
        environment variable.  To view the help for CMAKE:

        a. Run CMAKE with the /help (or equivalently /h) option:

           cmake /h

           or

        b. Run the QuickHelp program by using the command:

           qh cmake

           or

        c. Run the QuickHelp program by using the command:

           qh

           and select CMAKE from the "Categories" menu, or search for
           the topic, "cmake" (press S and enter the topic, cmake).

        Note that since QH will only open the first 15 files found in
        the directories given by the HELPFILES environment variable,
        you might have to list the CMAKE help directory first.  If QH
        does not open CMAKE.HLP automatically, you will have to
        manually open this help file/database after you start QH.

     -----------------------------------------------------------------
     Microsoft and MS-DOS are registered trademarks of Microsoft
     Corporation.

     Windows is a trademark of Microsoft Corporation.